home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Monster Media 1996 #15
/
Monster Media Number 15 (Monster Media)(July 1996).ISO
/
os2
/
te2pro20.zip
/
TE2PRO.INF
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1996-05-31
|
50KB
|
1,519 lines
ΓòÉΓòÉΓòÉ 1. Welcome ΓòÉΓòÉΓòÉ
Welcome to TE/2 Pro! Version 2.
This copy of TE/2 Pro! will cease to function after 50 executions unless you
provide a registration key. Please contact Oberon Software or the vendor from
which you purchased this copy of TE/2 Pro! to receive a registration key. If
this is a test drive (e.g., you downloaded it from a BBS or FTP site), then
please contact Oberon Software for purchasing information.
Oberon Software, Inc.
1405 East Main Street
Mankato, MN 56001-5070 USA
Phone: 507-388-7001
FAX: 507-388-7568
BBS: 507-388-1154
Internet: oberon@prairie.lakes.com
http://prairie.lakes.com/~oberon
To obtain help for any particular menu item, highlight that item from within
TE/2 Pro! and press the F1 key. You may also open the help file contents
window from within this help window and search for the item of interest.
A How Do I? section is also provided.
If all else fails, contact Oberon Software be e-mail or phone. We're always
happy to help!
Other points of interest are:
Getting Started
Product Overview
System Requirements
Oberon Software Info
ΓòÉΓòÉΓòÉ 2. TE/2 Pro! Overview ΓòÉΓòÉΓòÉ
TE/2 Pro! is Oberon Software's new, object-oriented, Workplace Shell aware,
telecommunications program for OS/2 Warp. TE/2 Pro!, based on the same
telecommunications engine, file transfer protocols, and terminal emulations as
Oberon's very successful, original TE/2, adds the desktop object behaviors and
drag and drop interfaces which OS/2 Warp users are used to while maintaining
the robustness and reliability of the original product.
In addition to long-standing TE/2 features such as robust, high-speed
telecommunications support, seven terminal emulation modes, fast, reliable file
transfer protocols, and extensive REXX scripting capabilities, some of the new
features for TE/2 Pro! will include:
Object Oriented User Interface.
- Terminal sessions and dialing directories appear as objects. These
objects use standard OS/2 notebook controls for their settings, may
be opened in various views, dragged to the printer or shredder as
OS/2 users would expect.
- Dialing directory entries can be copied or moved easily between
directories or dialed by simply dragging them to a terminal object.
Support for multiple, simultaneous sessions. One invocation of TE/2 Pro!
can support a virtually unlimited number of terminal sessions.
Terminal objects which do not compete for the same device may be active
simultaneously.
Asynch, TCP/IP, and Named Pipe support built in.
Any terminal object may be set to access a modem port, a TCP/IP socket
(if the user has TCP/IP installed), or a Named Pipe server.
Multiwindow chat and scroll back. Rather than the split-screen and/or
"modal" ways of handling these features, TE/2 Pro! uses standard OS/2
windows which can be sized, moved, retained, or closed as the user
desires.
Of course, copy and paste via the OS/2 clipboard is available throughout.
System Requirements
ΓòÉΓòÉΓòÉ 2.1. System Requirements ΓòÉΓòÉΓòÉ
IBM compatible with
Intel compatible 386 or better processor
8 megabytes of RAM
2 megabytes of unused hard disk space
VGA or better video card and monitor monitor
Serial port
(optional) TCP/IP software
ΓòÉΓòÉΓòÉ 3. Oberon Software ΓòÉΓòÉΓòÉ
Oberon Software has been developing OS/2 software and providing OS/2 related
services since 1988. More than just a specialty, OS/2 related products and
services are Oberon Software's only business. Other Oberon products include
FSHL - Oberon Software's Alternative Command Line Executive, DiskStat, LstPM,
and the Commpak/2 Programmer's Toolkit for creating telecommunications routines
under OS/2. In addition, Oberon Software has developed unique, OS/2 based
solutions for a number of major corporations in the banking and communication
industries.
Oberon Software, Inc.
1405 East Main Street
Mankato, MN 56001-5070 USA
Phone: 507-388-7001
FAX: 507-388-7568
BBS: 507-388-1154
Internet: oberon@prairie.lakes.com
http://prairie.lakes.com/~oberon
ΓòÉΓòÉΓòÉ 4. Getting Started ΓòÉΓòÉΓòÉ
Installing TE/2 Pro!
Starting TE/2 Pro!
Creating Terminals and Phone Books
Changing Settings
ΓòÉΓòÉΓòÉ 4.1. Installing TE/2 Pro! ΓòÉΓòÉΓòÉ
If you downloaded a test-drive version of TE/2 Pro!, you will first need
to unzip the archive file into a temporary directory or onto a diskette.
You should use an unzip utility such as Info-ZIP's unzip.exe.
Open an OS/2 folder for the diskette or directory which contains the TE/2
Pro! installation files -- or -- open an OS/2 command line session and
change disk/directory to that location.
Execute INSTALL.EXE by double-clicking on its icon or by typing "INSTALL"
at the OS/2 command prompt.
Follow the instructions given to you by the install program.
ΓòÉΓòÉΓòÉ 4.2. Starting TE/2 Pro! ΓòÉΓòÉΓòÉ
When you installed TE/2 Pro! an OS/2 desktop folder was created which contains
a TE/2 Pro! program object. Just double-click on this object to start TE/2
Pro!
ΓòÉΓòÉΓòÉ 4.3. Creating Terminals and Phone Books ΓòÉΓòÉΓòÉ
Terminals and phone books can be created by any of the following methods:
Click the right mouse button on any vacant area of the TE/2 screen
- Click on Create
- Click on either Terminal or Phone Book
Hold the Control Key down while dragging a Terminal or Phone Book object
- This will copy the object and immediately open its Settings Notebook
for you.
Click the right mouse button on a session icon.
- Select Create Another
Click the right mouse button on a Phone Book icon.
- Select Create Another
ΓòÉΓòÉΓòÉ 4.4. Changing Settings ΓòÉΓòÉΓòÉ
The Program Page of the OS/2 Program Object Settings Notebook can be
used:
- To pass options to TE/2 Pro!
- To set the default working directory to the directory in which you
installed TE/2 Pro!
The Settings Notebook for the main TE/2 Pro window can be used to change:
- Main window background
- Various sounds associated with
-- Program start
-- Program end
-- Program errors
-- Various notifications
-- Sounds associated with various file transfer actions
- Your Registration Name and ID
Terminal session settings can be changed by Clicking the right mouse
button on any Session icon Selecting the Settings notebook
Phone Book settings can be changed by Clicking the right mouse button on
any Phone Book icon Selecting the Settings notebook
ΓòÉΓòÉΓòÉ 5. How Do I? ΓòÉΓòÉΓòÉ
General How To... Comments
Use the Toolbox
Upload a file
Download a file
Capture data to a log file
Dial a number that is not in a Phone Book
Print a Phone Book
Use Copy and Paste
Use Chat Mode
ΓòÉΓòÉΓòÉ 5.1. General How To... Comments ΓòÉΓòÉΓòÉ
TE/2 Pro! gives you a choice of ways to accomplish any task. You can
1. Use menus to make a selection
2. Use Alt-key combinations to perform functions
3. Click on Toolbox icons to perform functions
All three ways are equally valid. Choose the interface that makes you feel
most comfortable.
ΓòÉΓòÉΓòÉ 5.2. Use the Toolbox ΓòÉΓòÉΓòÉ
The Toolbox allows you to click icons to accomplish things
Up arrow uploads a file
Down arrow downloads a file
The file icon with the superimposed arrow opens a log file
Scroll icon scrolls back through session activity
Telephone dial icon allows you to manually dial a number
Telephone handset icon allows you to hangup
Information about session settings is displayed. These settings can be
changed by clicking the left mouse button over the setting you wish to
change.
ΓòÉΓòÉΓòÉ 5.3. Upload a file ΓòÉΓòÉΓòÉ
In order to upload a file, you must have a session running. There are several
ways to upload a file.
Drag one or more file objects from an OS/2 folder onto a running TE/2
Pro! terminal session window. A dialog box will appear at the bottom of
the screen.
The file(s) you dragged onto TE/2 Pro will be listed in this dialog.
If you wish to add files to this dialog, you may
- Drag and drop more file objects onto the terminal window and/or
...
- Use the Select button to use a standard OS/2 file dialog
Select a protocol.
Click on Options to set any options for that protocol.
Click on select to choose the file(s) you wish to upload.
Click on Start Upload to begin the file transfer.
Click on the download icon in the toolbox. (The logfile icon is the
first icon on the left) A dialog box will appear at the bottom of the
screen.
Select a protocol.
Click on Options to set any options for that protocol.
Click on select to choose the file(s) you wish to upload.
Click on Start Upload to begin the file transfer.
Press Alt+U. Select a file transfer protocol. A dialog box will appear
at the bottom of the screen.
Select a protocol.
Click on Options to set any options for that protocol.
Click on select to choose the file(s) you wish to upload.
Click on Start Upload to begin the file transfer.
Click the right mouse button anywhere on running terminal session. A
popup menu will appear.
Select File.
When the second menu appears, select Upload.
A dialog box will appear at the bottom of the screen.
Select a protocol.
Click on Options to set any options for that protocol.
Click on select to choose the file(s) you wish to upload.
Click on Start Upload to begin the file transfer.
ΓòÉΓòÉΓòÉ 5.4. Download a file ΓòÉΓòÉΓòÉ
In order to download a file, you must have a session running. There are several
ways to download a file.
Click on the download icon in the toolbox. (The download icon is the
second icon on the left)
Select a protocol.
- If you chose one of the XMODEM protocols, you will be asked to
choose a name for the file you are about to download. This
name will become the name of the file when it is stored on your
computer.
- You will not be asked for a file name if you choose one of the
other file transfer protocols.
TE/2 Pro! will begin the file transfer.
Press Alt+N.
Select a protocol.
- If you chose one of the XMODEM protocols, you will be asked to
choose a name for the file you are about to download. This
name will become the name of the file when it is stored on your
computer.
- You will not be asked for a file name if you choose one of the
other file transfer protocols.
TE/2 Pro! will begin the file transfer.
Click the right mouse button anywhere on running terminal session. A
popup menu will appear.
Select File.
When the second menu appears, select Download
Select a protocol.
- If you chose one of the XMODEM protocols, you will be asked to
choose a name for the file you are about to download. This
name will become the name of the file when it is stored on your
computer.
- You will not be asked for a file name if you choose one of the
other file transfer protocols.
TE/2 Pro! will begin the file transfer.
ΓòÉΓòÉΓòÉ 5.5. Capture data to a log file ΓòÉΓòÉΓòÉ
In order to capture data to a log file, you must have a session running. There
are several ways to capture data to a log file.
Click on the logfile icon in the toolbox. (The logfile icon is the third
icon from the left) A file open dialog will appear.
Choose a file name. Click on OK
Press Alt+L. A file open dialog will appear.
Choose a file name. Click on OK
Click the right mouse button on the screen of an open session. A popup
menu will appear.
Click on File.
Click on Logfile.
Click on Open. A file open dialog will appear.
Choose a file name. Click on OK
ΓòÉΓòÉΓòÉ 5.6. Dial a number that is not in a Phone Book ΓòÉΓòÉΓòÉ
In order to manually dial a phone number, you must have a session running.
There are several ways to dial a number that is not in one of the Phone Books.
Click on the Telephone icon in the toolbox. (The Telephone icon is the
fourth icon from the left) An entryfield will appear.
Enter the phone number.
Click on OK.
Press Alt+M. An entryfield will appear.
Enter the phone number.
Click on OK.
Click the right mouse button on the screen of an open session. A popup
menu will appear.
Click on Dial. An entryfield will appear.
Enter the phone number.
Click on OK.
ΓòÉΓòÉΓòÉ 5.7. Print a Phone Book ΓòÉΓòÉΓòÉ
To print an entire Phone Book
Use the right mouse button to drag the Phone Book icon to a printer
object on the OS/2 desktop.
To print a single Phone Book entry
Open the Phone Book
Select the entry you want to print
Use the right mouse button to drag the Phone Book entry to a printer
object on the OS/2 desktop.
ΓòÉΓòÉΓòÉ 5.8. Use Copy and Paste ΓòÉΓòÉΓòÉ
These features allow you to use the OS/2 clipboard to transfer data between
TE/2 Pro! and another program.
To copy all the data in a session window
Click the right mouse button anywhere in the client area of the
session window
When the popup menu appears, click on Copy all
To copy selected data from a session window
Hold down the left mouse button
Drag the mouse across the data you want to capture from the session
window
Press Control+Insert or...
Click on the right mouse button. When the popup menu appears,
click on Copy.
Data copied to the clipboard can then be pasted into other OS/2
applications
To paste data into a session from another application
Press Shift+Insert or...
Click the right mouse button anywhere in the client area of the
session window. When the popup menu appears, click on Paste.
ΓòÉΓòÉΓòÉ 5.9. Use Chat mode ΓòÉΓòÉΓòÉ
TE/2 Pro! supplies a built in, split window chat mode for use with the CB
Simulators provided by some on-line services, multiuser real-time conferences
provided by some services and bulletin boards, and chatting with bulletin board
sysops if they offer a chat mode on their BBS.
To activate the "Remote Input Window":
Press Alt+G or ...
Click the right mouse button on the screen of an open session. A popup
menu will appear.
Click on Options.
Click on Remote Input Window.
When the Remote Input Window is active, anything you type into it will be
transmitted as though you had typed it into the TE/2 Pro! terminal window
(with some differences, noted below). The regular terminal window is still
active while the Remote Input Window is displayed and it may be used as
normal.
The Remote Input Window has its own popup menu that is activated by clicking
the right mouse button anywhere in its window. The special features of the
Remote Input Window are:
Buffered Input:
If Buffered Input is active, no typed characters will be
transmitted until you press ENTER.
If Buffered Input is not active, typed characters are transmitted
as you type them.
The options submenu allows you to:
Turn the scroll bars for this window on and off.
Change the character font for this window.
Change the size (rows and columns) for this window.
ΓòÉΓòÉΓòÉ 6. Scripting ΓòÉΓòÉΓòÉ
TE/2 Pro! scripts are all written using the REXX scripting language which is
built into OS/2. This document is not intended to be a tutorial on the REXX
language. For information on the REXX language, you can begin by reading the
online REXX document which comes with OS/2. This document is usually located in
the OS/2 "Information" folder. There are also many good books available which
cover the REXX language in detail.
Because of the extensible nature of REXX, you can use TE/2 Pro! REXX scripts in
conjuction with any of the REXX extension packages available:
OS/2 includes a REXXUTIL package which provides OS/2 system and file
services.
Visual REXX tools, such as Hockware's VisPro REXX and Watcom's VXREXX
give you the ability to create dialog boxes and other GUI features with
your REXX programs and scripts.
Communications Manager/2 provides a REXX extension package if you need to
use HLLAPI to communicate with your host sessions.
DB2/2 provides a REXX package for accessing its databases.
REXX socket services and FTP services are available from IBM and others
for use in REXX programs and scripts.
And so on...
When TE/2 Pro! executes a REXX script, it acts as a subcommmand handler. That
is, any command which REXX doesn't recognize will be routed back into TE/2
Pro! to be executed. This documents will cover the subcommands which TE/2
Pro! recognizes.
How to execute TE/2 Pro! scripts
Subcommand reference
ΓòÉΓòÉΓòÉ 6.1. How to execute TE/2 Pro scripts ΓòÉΓòÉΓòÉ
In general, TE/2 Pro! scripts must reside in the current working directory.
That is, the directory in which the TE/2 Pro! executable is running.
Alternately, you may define an environment variable TPSCRIPTPATH which should
contain a semi-colon delimited list of directories in which TE/2 Pro! should
look for its scripts. If no path is provided when you execute the script, TE/2
Pro! will always look in the current directory first and then in the
directories listed in TPSCRIPTPATH.
There are several ways to execute TE/2 Pro! scripts:
Automatically when you dial a Phone Book entry
Enter the script name in the "Script" field of the Phone Book entry.
The script will be executed once a successful connection has been
made to this site.
Automatically when you open or close a Terminal Session
Enter the script name(s) in the Terminal Settings Notebook on the
Session->Scripts page.
Scripts can be executed:
- When the terminal starts, before the device has been opened.
- When the terminal starts, after the device has been opened.
- When the terminal closes, before the device is closed.
- When the terminal closes, after the device is closed.
Manually from a Terminal Session's popup menu
- From the popup menu select File->Script->Run...
- To re-run the last script, select File->Script->Repeat
- To halt a running script, select File->Script->Halt
- If you expect to run a particular script quite often during the
current session, you may load it into memory by selecting
File->Script->Load. This will save on disk access time on
subsequent executions of the script.
ΓòÉΓòÉΓòÉ 6.2. Subcommand reference ΓòÉΓòÉΓòÉ
The following subcommands are recognized by TE/2 Pro!
CLOSE
CLS
DOWNLOAD
EXECWAIT
HANGUP
LOGFILE
MESSAGEBOX
MESSAGEBOXV
QUERY BAUD
QUERY CARRIER
QUERY DATABITS
QUERY DEVICE
QUERY DEVICEHANDLE
QUERY DEVICESTATE
QUERY PARITY
QUERY STOPBITS
RCVCAPTURE
RECEIVE
RUN
SAY
SET BAUD
SET DATABITS
SET PARITY
SET STOPBITS
SLEEP
STARTSESSION
TRANSMIT
UPLOAD
WAIT
WAITV
WAITXFER
ΓòÉΓòÉΓòÉ 6.2.1. CLOSE ΓòÉΓòÉΓòÉ
Parameters: None
Note: This posts a "CLOSE" message to the terminal window. It
will close within microseconds so you are STRONGLY advised
to make this the final statement in your script just
before the REXX "exit" statement. If the terminal has
either an UnInit or CleanUp script (or both) defined, they
will be executed as normal.
Returns: Always 0
ΓòÉΓòÉΓòÉ 6.2.2. CLS ΓòÉΓòÉΓòÉ
Parameters: None
Note: Clears the terminal screen to blanks.
Returns: Always 0
ΓòÉΓòÉΓòÉ 6.2.3. DOWNLOAD ΓòÉΓòÉΓòÉ
Parameters:
protocol (Required) Must be one of:
xmodem
xmodem1k
ymodem
ymodemg
zmodem
filename Required for xmodem and xmodem1k. Ignored
otherwise.
Note: File transfer proceeds asynchronously. See WAITXFER.
Returns:
0 transfer started
1 transfer did not start
256 terminal is busy
Examples:
'DOWNLOAD XMODEM1K file.dat'
'DOWNLOAD ZMODEM'
ΓòÉΓòÉΓòÉ 6.2.4. EXECWAIT ΓòÉΓòÉΓòÉ
Parameters:
program (Required) File path/name to executable
program
arguments (Optional) Command line parameters for
executed program
Note: Runs the specified program with all defaults set (see
STARTSESSION) and waits for it to complete before
returning.
Returns: Return value from executed program
Example:
'EXECWAIT c:\os2\chkdsk.com a:'
ΓòÉΓòÉΓòÉ 6.2.5. HANGUP ΓòÉΓòÉΓòÉ
Parameters: None
Note: Sends the defined hangup sequence to the device.
Returns: FALSE if CD is high after hangup, TRUE otherwise
ΓòÉΓòÉΓòÉ 6.2.6. LOGFILE ΓòÉΓòÉΓòÉ
Parameters:
option Must be one of the following:
query
open
append
close
activate
pause
toggle
filename Required for options "open" and "append".
Ignored otherwise.
Returns: The state and filename of the current logfile. Note: If
the state is "CLOSED", there is no filename. Possible
states are:
ACTIVE
PAUSED
CLOSED
ΓòÉΓòÉΓòÉ 6.2.7. MESSAGEBOX ΓòÉΓòÉΓòÉ
Parameters:
text (Required) The text to display in the
message box area.
title (Optional) Title bar text for message box.
style (Optional) Style for the message box. See
notes.
Note:
If "title" is not specified, the name of the running
script is placed in the title bar.
If "style" is not specified, the message box will be
movable, have the OS/2 "Info" icon, and an Enter
button.
If "style" is specified, it must be a numeric value
which represents the style. A list of useful style
values is given below.
If your "style" does not otherwise contain a button,
an Enter button will be added.
Returns: The return value from the message box. Possible values
are:
1 OK button pressed
2 CANCEL button pressed
3 ABORT button pressed
4 RETRY button pressed
5 IGNORE button pressed
6 YES button pressed
7 NO button pressed
8 HELP button pressed
9 ENTER button pressed
Else An error occurred
Styles: These values may be combined by binary ORing them together:
Buttons
0 OK
1 OK, CANCEL
2 RETRY, CANCEL
3 ABORT, RETRY, IGNORE
4 YES, NO
5 YES, NO, CANCEL
6 CANCEL
7 ENTER
8 ENTER, CANCEL
Icons
0 No icon
16 Question
32 Warning
48 Info
64 Critical
Other
256 Button 2 is default
512 Button 3 is default
4096 System modal
16384 Moveable
Example:
/* 0x4046 is moveable+critical+cancel button */
'MESSAGEBOX "A critical error occurred!" "Error!"' X2D('4046')
ΓòÉΓòÉΓòÉ 6.2.8. MESSAGEBOXV ΓòÉΓòÉΓòÉ
Parameters: (Required) REXX stem variable name (see note)
Note: This is another, perhaps more concise way to call
MESSAGEBOX. All notes regarding return codes and style
given there apply here as well.
The stem variable can contain the following fields:
text (Required) The text to display in the
message box area.
title (Optional) Title bar text for message box.
style (Optional) Style for the message box.
Returns: Same as MESSAGEBOX
Example:
msgbox.text = 'A Critical Error Occurred!'
msgbox.title = 'Error!'
msgbox.style = x2D('4046') /* moveable, critical, cancel button */
'MESSAGEBOXV msgbox'
ΓòÉΓòÉΓòÉ 6.2.9. QUERY BAUD ΓòÉΓòÉΓòÉ
Parameters: (Optional) REXX variable name
Note: If supplied, the REXX variable will be filled in with the
same value as the return code. Since REXX treats return
values as signed integers, you will get negative results
in RC for 38,400 baud and greater. Use this option for
more consistant results.
Returns: Current baud rate
ΓòÉΓòÉΓòÉ 6.2.10. QUERY CARRIER ΓòÉΓòÉΓòÉ
Parameters: (Optional) REXX variable name
Note: If supplied, the REXX variable will be filled in with the
same value as the return code.
Returns:
0 Terminal is NOT online
1 Terminal is online
ΓòÉΓòÉΓòÉ 6.2.11. QUERY DATABITS ΓòÉΓòÉΓòÉ
Parameters: (Optional) REXX variable name
Note: If supplied, the REXX variable will be filled in with the
same value as the return code.
Returns: Current databit setting
ΓòÉΓòÉΓòÉ 6.2.12. QUERY DEVICE ΓòÉΓòÉΓòÉ
Parameters: (Optional) REXX variable name
Note: If supplied, the REXX variable will be filled in with the
same value as the return code.
Returns: Current device name
ΓòÉΓòÉΓòÉ 6.2.13. QUERY DEVICEHANDLE ΓòÉΓòÉΓòÉ
Parameters: (Optional) REXX variable name
Note: If supplied, the REXX variable will be filled in with the
same value as the return code.
Returns: Current device handle
ΓòÉΓòÉΓòÉ 6.2.14. QUERY DEVICESTATE ΓòÉΓòÉΓòÉ
Parameters: (Required) REXX variable name
Note: Uses the REXX variable as a stem variable and fills in the
following fields:
Device Current device name
Baud Current baud rate
Parity Current parity (see QUERY PARITY)
DataBits Current databit setting
StopBits Current stopbit setting (see QUERY
STOPBITS)
Carrier 1 if online, 0 if not
Handle Current device handle
Returns: Always 0
Example:
devstate. = '' /* clear out the variable */
'QUERY DEVICESTATE devstate'
say devstate.device 'is set to' devstate.baud'bps'
ΓòÉΓòÉΓòÉ 6.2.15. QUERY STOPBITS ΓòÉΓòÉΓòÉ
Parameters: (Optional) REXX variable name
Note: If supplied, the REXX variable will be filled in with the
same value as the return code.
Returns: Current stopbit setting: 1, 1.5, or 2
ΓòÉΓòÉΓòÉ 6.2.16. QUERY PARITY ΓòÉΓòÉΓòÉ
Parameters: (Optional) REXX variable name
Note: If supplied, the REXX variable will be filled in with the
same value as the return code.
Returns: Current parity setting: None, Even, Odd, Mark, or Space.
ΓòÉΓòÉΓòÉ 6.2.17. RCVCAPTURE ΓòÉΓòÉΓòÉ
Parameters: (Required) "TRUE' or "FALSE"
Note: RCVCAPTURE TRUE ensures that all modem input will be held
until the script issues a RECEIVE statement. Receive
Capture mode MUST be turned off with RCVCAPTURE FALSE
explicitly!
Returns: Always 0
ΓòÉΓòÉΓòÉ 6.2.18. RECEIVE ΓòÉΓòÉΓòÉ
Parameters:
length (Required) "nnn" or "CRnnn" where "nnn" is
a number between 1 and 255. If "CR" is
specified, the receive will terminate early
if it encounters a carriage return
character from the remote.
timeout (Required) Timeout value in seconds. -1
specifies an infinite timeout.
echo (Optional) "ECHO" or "NOECHO". If it is
neither, the first character of the string
specifes the character to echo. If the
parameter is omitted, defaults to NOECHO.
prefix (Optional) string (one word) which will be
prefixed to the result if the result string
is longer than zero characters. Use this
to overcome REXX's habit of modifying
return strings which start with numeric
values. Note that you must specify ECHO or
NOECHO to use this parameter.
Note: Filtering of backspaces from the remote occurs if 'length'
is greater than 1.
Returns: Length or received string.
ΓòÉΓòÉΓòÉ 6.2.19. RUN ΓòÉΓòÉΓòÉ
Parameters:
script (Required) script file name
args (Optional) arguments for script
Note: Runs the indicated script synchrounously.
Returns: return code from executed script.
ΓòÉΓòÉΓòÉ 6.2.20. SAY ΓòÉΓòÉΓòÉ
Parameters: any string
Note: Exactly equivalent to the REXX SAY statement.
Returns: Always 0
ΓòÉΓòÉΓòÉ 6.2.21. SET BAUD ΓòÉΓòÉΓòÉ
Parameters: (Required) value
Note: value must be one of: 110, 150, 300, 600, 1200, 2400,
4800, 9600, 19200, 38400, 57600, 115200, or 230400.
Returns: "OK" or "ERROR"
ΓòÉΓòÉΓòÉ 6.2.22. SET DATABITS ΓòÉΓòÉΓòÉ
Parameters: (Required) value
Note: value must be one of: 5, 6, 7, or 8.
Returns: "OK" or "ERROR"
ΓòÉΓòÉΓòÉ 6.2.23. SET PARITY ΓòÉΓòÉΓòÉ
Parameters: (Required) value
Note: value must be one of: "none", "even", "odd", "mark", or
"space"
Returns: "OK" or "ERROR"
ΓòÉΓòÉΓòÉ 6.2.24. SET STOPBITS ΓòÉΓòÉΓòÉ
Parameters: (Required) value
Note: value must be one of: 1, 1.5, or 2
Returns: "OK" or "ERROR"
ΓòÉΓòÉΓòÉ 6.2.25. SLEEP ΓòÉΓòÉΓòÉ
Parameters: (Required) value
Note: value is sleep time in seconds
Returns: Always 0
ΓòÉΓòÉΓòÉ 6.2.26. STARTSESSION ΓòÉΓòÉΓòÉ
Parameters:
REXX var (Required) see note
"WAIT" (Optional) If specified, execution of
script pauses until child session ends.
Note: The REXX variable may have any and all of the following
fields set:
Related 0 or 1 (default 1) indicates an
independant or a child session,
respectively
FgBg 0 or 1 (default 0) indicates the
session is to be run in the Foreground
or Background respectively
PgmTitle Window title for the session, default
is the empty string which results in
the default title bar text (usually
the executable file name).
PgmName The program to run, must include the
file extension although the file
extension must be specified. If left
blank, CMD.EXE will run.
PgmInputs Commandline arguments for the program.
Environment Do not use this unless you are
familiar with environment blocks.
This field is ignored for DOS (VDM)
sessions.
InheritOpt 0 or 1 (default 1) indicates that the
session is to inherit the OS/2 shell's
environment or TE/2 Pro's
respectively.
SessionType Default is 0 (default session type
based on the program file itself).
Otherwise, the value is chosen from
this list:
1 Fullscreen OS/2 session
2 Windowed OS/2 session
3 Presentation manager session
4 Fullscreen DOS (VDM) session
7 Windowed DOS (VDM) session
IconFile If left blank (the default), OS/2
provides a default icon for the
session.
PgmControl Choose from the table below, the
default is 0. This field is ignored
for fullscreen sessions.
0 visible
1 invisible
2 maximized
4 minimized
+8 Do not close on exit
Returns: Return code from program or OS/2 error code.
Example:
pgm. = ''
pgm.PgmName = 'c:\os2\apps\pmseek'
pgm.InheritOpt = 0
pgm.SessionType = 3
'STARTSESSION pgm WAIT'
ΓòÉΓòÉΓòÉ 6.2.27. TRANSMIT ΓòÉΓòÉΓòÉ
Parameters: (Required) quoted string
Note: Use double quotes to quote the string. If the string does
not contain any space characters, it does not need to be
quoted.
Returns: Number of bytes transmitted.
Examples:
'TRANSMIT "Hello World"'
Reset = 'ATZ'||D2C(13)
'TRANSMIT' Reset
Hello = 'Hello World'
'TRANSMIT "'Hello'"'
ΓòÉΓòÉΓòÉ 6.2.28. UPLOAD ΓòÉΓòÉΓòÉ
Parameters:
protocol (Required) Must be one of:
xmodem
xmodem1k
ymodem
ymodemg
zmodem
ascii
filename(s) (Required) see note
Note: If "protocol" is "xmodem" or "xmodem1k", then "filename"
must be a single, non-ambiguous filename. If "protocol"
is anything else, then "filename" may contain a
comma-delimited list of filenames, any of which may or may
not be ambiguous.
File transfer proceeds asynchronously. See WAITXFER.
Returns:
0 transfer started
1 transfer did not start
256 terminal is busy
ΓòÉΓòÉΓòÉ 6.2.29. WAIT ΓòÉΓòÉΓòÉ
Parameters:
value (Required) seconds to wait
string(s) At least one string is required, may have
up to 10 total
Note: arguments after the 10th string are ignored and do not
cause an error
Returns: index of matched string or 0 if timeout, 10000 if keyboard
abort
Examples:
'WAIT 60 "OK"'
'WAIT 10 "ERROR" "OK"'
ΓòÉΓòÉΓòÉ 6.2.30. WAITV ΓòÉΓòÉΓòÉ
Parameters:
value (Required) seconds to wait
REXX var (Required) see note
Note: variable.0 must contain count, strings must be in
variable.1, variable.2, etc. If more than 10 are
specified, only the first 10 are used and no error is
generated
Returns: index of matched string or 0 if timeout, 10000 if keyboard
abort
Example:
srch.0 = 2
srch.1 = 'OK'
srch.2 = 'ERROR'
'WAITV 10 srch'
ΓòÉΓòÉΓòÉ 6.2.31. WAITXFER ΓòÉΓòÉΓòÉ
Parameters: None
Note: Pauses script execution until the current file transfer
ends.
Returns:
0 transfer succeeded
1 transfer failed
256 no transfer in progress
ΓòÉΓòÉΓòÉ 7. Help for Open ΓòÉΓòÉΓòÉ
Help for Open Menu
ΓòÉΓòÉΓòÉ 7.1. Help for Open Settings ΓòÉΓòÉΓòÉ
Choose this if you wish to open the settings notebook for the TE/2 Pro! main
container.
ΓòÉΓòÉΓòÉ 7.2. Help for Open Terminal ΓòÉΓòÉΓòÉ
Help for Open Settings Terminal
ΓòÉΓòÉΓòÉ 7.3. Help for Open Phonebook ΓòÉΓòÉΓòÉ
Help for Open Settings Phonebook
ΓòÉΓòÉΓòÉ 7.4. Help for Open Dialer ΓòÉΓòÉΓòÉ
Help for Open Dialer
ΓòÉΓòÉΓòÉ 8. Help for View ΓòÉΓòÉΓòÉ
Choose this if you wish to select between an Icon, Details, Name, or Text view
of the dialing directory entries.
ΓòÉΓòÉΓòÉ 8.1. Help for View Icon ΓòÉΓòÉΓòÉ
Choose this if you wish to select an Icon view of the dialing directory
entries.
ΓòÉΓòÉΓòÉ 8.2. Help for View Details ΓòÉΓòÉΓòÉ
Choose this if you wish to select a Details view of the dialing directory
entries.
ΓòÉΓòÉΓòÉ 8.3. Help for View Name ΓòÉΓòÉΓòÉ
Choose this if you wish to select a Name view of the dialing directory entries.
ΓòÉΓòÉΓòÉ 8.4. Help for View Text ΓòÉΓòÉΓòÉ
Choose this if you wish to select a Text view of the dialing directory entries.
ΓòÉΓòÉΓòÉ 9. Help for Refresh ΓòÉΓòÉΓòÉ
Choose this if you want to Refresh the window for the TE/2 Pro! main container.
ΓòÉΓòÉΓòÉ 10. Help for Help Menu ΓòÉΓòÉΓòÉ
Choose this if you want Help for the TE/2 Pro! main container window.
ΓòÉΓòÉΓòÉ 11. Help for Create ΓòÉΓòÉΓòÉ
Choose this if you wish to either create a terminal or a phone book.
ΓòÉΓòÉΓòÉ 11.1. Help for Create Terminal ΓòÉΓòÉΓòÉ
Choose this if you wish to create a new terminal session. The session will be
a copy of the default session. You will, however, be prompted to change any or
all of the settings of the newly created session.
ΓòÉΓòÉΓòÉ 11.2. Help for Copy Terminal ΓòÉΓòÉΓòÉ
Choose this if you wish to create a copy of the currently selected terminal
session. You will be prompted to change any or all of the settings of the
original session.
ΓòÉΓòÉΓòÉ 11.3. Help for Delete Terminal ΓòÉΓòÉΓòÉ
Help for Delete Terminal Choose this if you wish to delete the currently
selected terminal session.
ΓòÉΓòÉΓòÉ 11.4. Help for Create Phone Book ΓòÉΓòÉΓòÉ
Choose this if you wish to create a new phone book. You will be prompted to
choose between a copy of the currently selected phone book and a copy of the
default phone book.
ΓòÉΓòÉΓòÉ 11.5. Help for Copy Phone Book ΓòÉΓòÉΓòÉ
Choose this if you wish to copy the currently selected phone book.
ΓòÉΓòÉΓòÉ 11.6. Help for Delete Phone Book ΓòÉΓòÉΓòÉ
Choose this if you wish to delete the currently selected phone book.
ΓòÉΓòÉΓòÉ 11.7. Help for Create Directory Entry ΓòÉΓòÉΓòÉ
Choose this if you want to create a directory entry. You will be asked to
supply various items of information for the directory entry such as Name,
Number, Baud Rate, etc.
ΓòÉΓòÉΓòÉ 11.8. Help for Duplicate Directory Entry ΓòÉΓòÉΓòÉ
Choose this if you wish to duplicate the currently selected directory entry or
entries.
ΓòÉΓòÉΓòÉ 12. Help for Copy Directory Entry ΓòÉΓòÉΓòÉ
Choose this if you want to copy the currently selected directory entry or
entries. You will be prompted for a phone book to copy the selected entry or
entries to.
ΓòÉΓòÉΓòÉ 13. Help for Move Directory Entry ΓòÉΓòÉΓòÉ
Choose this if you want to move the currently selected directory entry or
entries from the currently active phone book to some other phone book.
ΓòÉΓòÉΓòÉ 14. Help for Delete Directory Entry ΓòÉΓòÉΓòÉ
Choose this if you wish to delete the currently selected directory entry or
entries from the currently active phone book.
ΓòÉΓòÉΓòÉ 15. Help for Select ΓòÉΓòÉΓòÉ
Choose this if you want to select or deselect every entry in the dialing
directory of the currently active phone book.
ΓòÉΓòÉΓòÉ 15.1. Help for Select All ΓòÉΓòÉΓòÉ
Choose this if you want to select every entry in the dialing directory of the
currently active phone book.
ΓòÉΓòÉΓòÉ 15.2. Help for Deselect All ΓòÉΓòÉΓòÉ
Choose this if you want to deselect every entry in the dialing directory of the
currently active phone book.
ΓòÉΓòÉΓòÉ 16. Help for Sort ΓòÉΓòÉΓòÉ
Choose this if you wish to sort the currently active phone book. You will be
prompted with a choice of sort criteria including ID, Name, Number, Last
Connect, and Connect Count.
ΓòÉΓòÉΓòÉ 16.1. Help for Sort by Name ΓòÉΓòÉΓòÉ
Choose this if you wish to sort the main container according to the names of
the sessions.
ΓòÉΓòÉΓòÉ 16.2. Help for Sort by Type ΓòÉΓòÉΓòÉ
Choose this if you wish to sort the main container according to the Type
(Description) of the sessions.
ΓòÉΓòÉΓòÉ 16.3. Help for Sort Directory by Tag ΓòÉΓòÉΓòÉ
Choose this if you wish to sort the currently active phone book by ID.
ΓòÉΓòÉΓòÉ 16.4. Help for Sort Directory by Name ΓòÉΓòÉΓòÉ
Choose this if you wish to sort the currently active phone book by Name.
ΓòÉΓòÉΓòÉ 16.5. Help for Sort Directory by Number ΓòÉΓòÉΓòÉ
Choose this if you wish to sort the currently active phone book by Number.
ΓòÉΓòÉΓòÉ 16.6. Help for Sort Directory by Connect Date ΓòÉΓòÉΓòÉ
Choose this if you wish to sort the currently active phone book by Connect
Date.
ΓòÉΓòÉΓòÉ 16.7. Help for Sort Directory by Connect Count ΓòÉΓòÉΓòÉ
Choose this if you wish to sort the currently active phone book by Connect
Count.
ΓòÉΓòÉΓòÉ 17. Help for Arrange ΓòÉΓòÉΓòÉ
Choose this if you wish to arrange icons.
ΓòÉΓòÉΓòÉ 18. Help for File ΓòÉΓòÉΓòÉ
Choose this if you wish to upload or download a file, open, close or pause a
logfile, run, repeat, halt, load or unload a script file.
ΓòÉΓòÉΓòÉ 18.1. Help for Upload ΓòÉΓòÉΓòÉ
Choose this if you wish to upload a file. You will be prompted for the name and
path of the file to be uploaded. Once that information is obtained, the file
will be placed in the upload queue.
ΓòÉΓòÉΓòÉ 18.2. Help for Download ΓòÉΓòÉΓòÉ
Choose this if you wish to download a file. You will be prompted for a choice
of protocol for the download. Available protocols include XModem, XModem1k,
YModem, YModem-G, ZModem.
ΓòÉΓòÉΓòÉ 18.3. Help for Logfile ΓòÉΓòÉΓòÉ
Choose this if you wish to open, close or pause a logfile. If you choose to
open a logfile, you will be asked to supply a name for the logfile. This can be
an already existing file or a new file.
ΓòÉΓòÉΓòÉ 18.4. Help for Script ΓòÉΓòÉΓòÉ
Choose this if you wish to Run, Repeat, Halt, Load, or Unload a script file.
ΓòÉΓòÉΓòÉ 18.5. Help for Options ΓòÉΓòÉΓòÉ
Choose this if you wish to affect the following options: Horizontal Scrollbar,
Vertical Scrollbar Font, Local Echo, Carriage Return - Carriage Return Line
Feed Conversion, Toolbox, Remote Input Window, and Review Window
ΓòÉΓòÉΓòÉ 18.6. Help for Emulations ΓòÉΓòÉΓòÉ
Choose this if you wish to change the currently selected emulation. Available
emulations include TTY, ANSI, ANSI-TE2, VT 100/102, IBM3101, and Avatar.
ΓòÉΓòÉΓòÉ 19. Help for Copy ΓòÉΓòÉΓòÉ
Choose this if you wish to copy the selected contents of the terminal screen to
the copy buffer.
ΓòÉΓòÉΓòÉ 20. Help for Copy all ΓòÉΓòÉΓòÉ
Choose this if you wish to copy the entire terminal screen to the copy buffer.
ΓòÉΓòÉΓòÉ 21. Help for Paste ΓòÉΓòÉΓòÉ
Choose this if you wish to paste the contents of the copy buffer to terminal
screen.
ΓòÉΓòÉΓòÉ 22. Help for Clear (mark) ΓòÉΓòÉΓòÉ
Choose this if you wish to unmark a marked area of the terminal session.
ΓòÉΓòÉΓòÉ 23. Help for Clear screen ΓòÉΓòÉΓòÉ
Choose this if you wish to clear the terminal screen.
ΓòÉΓòÉΓòÉ 24. Help for Send break ΓòÉΓòÉΓòÉ
Choose this if you wish to send a break signal to the terminal.
ΓòÉΓòÉΓòÉ 25. Help for Send init ΓòÉΓòÉΓòÉ
Choose this if you wish to send an initialization signal to the modem.
ΓòÉΓòÉΓòÉ 26. Help for Manual Dial ΓòÉΓòÉΓòÉ
Choose this if you wish to perform a manual dial. You will be prompted for a
phone number to dial.
ΓòÉΓòÉΓòÉ 27. Help for Hangup ΓòÉΓòÉΓòÉ
Choose this if you wish to send a hangup signal to the modem.
ΓòÉΓòÉΓòÉ 28. Help for Close ΓòÉΓòÉΓòÉ
Choose this if you wish to close the currently open terminal session.
ΓòÉΓòÉΓòÉ 29. Help for Window Menu ΓòÉΓòÉΓòÉ
ΓòÉΓòÉΓòÉ 29.1. Help for Restore Window ΓòÉΓòÉΓòÉ
Choose this if you wish to restore the window of the currently active terminal
session.
ΓòÉΓòÉΓòÉ 29.2. Help for Move Window ΓòÉΓòÉΓòÉ
Choose this if you wish to move the window of the currently active terminal
session.
ΓòÉΓòÉΓòÉ 29.3. Help for Size Window ΓòÉΓòÉΓòÉ
Choose this if you wish to change the size of the window of the currently
active terminal session.
ΓòÉΓòÉΓòÉ 29.4. Help for Minimize Window ΓòÉΓòÉΓòÉ
Choose this if you wish to minimize the window of the currently active terminal
session.
ΓòÉΓòÉΓòÉ 29.5. Help for Maximize Window ΓòÉΓòÉΓòÉ
Choose this if you wish to maximize the window of the currently active terminal
session.
ΓòÉΓòÉΓòÉ 29.6. Help for Hide Window ΓòÉΓòÉΓòÉ
Choose this if you wish to hide the window of the currently active terminal
session.
ΓòÉΓòÉΓòÉ 29.7. Help for Close Window ΓòÉΓòÉΓòÉ
Choose this if you wish to close the window of the currently active terminal
session.
ΓòÉΓòÉΓòÉ 29.8. Help for Window List ΓòÉΓòÉΓòÉ
Choose this if you wish to see a list of active programs. This has the same
effect as pressing Ctrl-Esc.
ΓòÉΓòÉΓòÉ 30. Help for Buffered Chat Mode ΓòÉΓòÉΓòÉ
Choose this if you wish to buffer the current chat session. In an unbuffered
session, all typed characters are sent immediately to the modem; in a buffered
session, typed characters are not sent to the modem until a carriage return is
entered.
ΓòÉΓòÉΓòÉ 31. Help for Switch to Main Window ΓòÉΓòÉΓòÉ
Choose this if you wish to switch from the Chat window to the Main window of
the currently active terminal session.
ΓòÉΓòÉΓòÉ 32. Help for Refresh Scrollback ΓòÉΓòÉΓòÉ
Choose this if you wish to Refresh the Scrollback Buffer.
ΓòÉΓòÉΓòÉ 33. Dialer Help ΓòÉΓòÉΓòÉ
Help for Dialer
ΓòÉΓòÉΓòÉ 34. Keys Help ΓòÉΓòÉΓòÉ
Choose this if you wish to obtain help on the various key assignments in TE/2
Pro!